"""This module provides common tools for working with geoimage supported by gdal/rasterio

- gdal_sys.py
    - a wrapper around the gdal dataset (`GDALRaster`) to avoid several known issues,
      including potential memory leak, some common configs, etc.
    - several other utility functions
- virtual_raster.py
    - a wrapper around core functionality of using virtual raster in gdal (`VRTScene`)
    - several other utility functions
- raster_dataset.py
    - a class for representing small to medium size **in-memory** `RasterDataset`
      as a combination of ndarray and companion metadata
    - several related utility functions
- rasterio_utils.py
    - tools based on `rasterio`, and occasionally calling gdal binaries with subprocess
    - so it can be compatible with our current tools under `stat`
        - `rasterio` wraps its own `gdal` binary and make certain assumptions about the memory management
        - it has been shown that using `gdal`'s python binding together with `rasterio` might lead to memory corruption
    - please refer in the file to see the function list
    - this could be deprecated in the future as we gradually move away from using `rasterio`
"""
